home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wc30view.zip / WC30VIEW.DOC < prev    next >
Text File  |  1992-03-10  |  9KB  |  182 lines

  1. WC30VIEW.EXE
  2.  
  3. For WILDCAT 3.0+ only!      (c) 1992       Karl Schneider
  4.                                            8505 Woodwick Ct.
  5.                                            Tampa, FL 33615
  6.                                            813-884-9661 voice days
  7.                                             "  "    "  BBS Midnite to
  8.                                                        0800 only!
  9. --------------------------------------------------------------------
  10. 3-10-92: Fix, was failing to read some DOOR.SYS files correctly when
  11. the WC board had a very large number of conferences.
  12. --------------------------------------------------------------------
  13. 11/19/91 Note:  WC30VIEW can be used for another purpose, which I
  14. hadn't even thought about until talking with Gaylon O'Dell.  It can
  15. be called from a DOOR to read a .ZIP'd, ARJ'd, ARC'd or LZH'd file
  16. such as a newsletter, etc.  Just replace the '%1' argument with
  17. the archive file name.
  18. --------------------------------------------------------------------
  19. 11/02/91 update.  Fixed problems with COM ports 3 and higher with
  20. nonstandard IRQ, address, etc.  WC30VIEW now begins with MAKEWILD
  21. to get Port, IRQ & address, then checks for SET WCPORTID, SET
  22. WCIRQID, SET WCBASEID, and SET WCMDM and uses the values from these
  23. environment variables.  (See pages 32 & 278 in your manual).
  24. These changes are transparent to the sysop;  setup and operation are
  25. unchanged.  Also added code to display 'time remaining' while awaiting
  26. a response from the caller, and changed the timeout values:  if the
  27. caller doesn't input a command within one minute, or drops carrier
  28. at any time, control is returned to WILDCAT.
  29. --------------------------------------------------------------------
  30. 10/1/91 Maint. update, minor changes.
  31. --------------------------------------------------------------------
  32. 9/29/91 update.  Made DV aware, added code to operate with COM
  33. ports 3 and 4, using IRQ and port address directly from WC setup.
  34. Should work on most any port setup.  Replace any versions dated
  35. prior to 9/29/91.
  36. --------------------------------------------------------------------
  37. 9/20/91 update.  Discovered some DOOR.SYS files have more than 1
  38. line of Conferences Joined....fixed to skip these to get proper
  39. Wildcat Home node dir.  Please discard earlier dated versions.
  40. ---------------------------------------------------------------------
  41.  
  42. WC30VIEW allows a user to view any .DOC, .TXT, READ-ME...etc. (ASCII)
  43. file within a .ZIP, .ARC, .ARJ or .LZH archive in your download areas.
  44. It will immediately reject any request to read a .COM or .EXE file,
  45. and, in the case of other strangely-named files which may not be
  46. readable, aborts the read if it detects strings of 'binary' char-
  47. acters which wouldn't make sense anyway. Any WC indexed file with
  48. a .ZIP, .ARC, .ARJ or .LZH extension can be viewed; anything else
  49. is rejected.
  50.  
  51. I would like to thank Vernon Buerg for graciously extending permis-
  52. sion to include his fine FV utility in this archive, and Robert
  53. K. Jung, the author of ARJ, an excellent archiving utility which
  54. is becoming deservedly popular.
  55.  
  56. Following is a short excerpt from AV.C which is distributed with
  57. the ARJ archives:
  58. /***************************************************************
  59.  AV.C, ARJ, R JUNG, 01/28/91
  60.  Display the contents of an ARJ archive
  61.  Copyright (c) 1990 by Robert K Jung.  All rights reserved.
  62.  
  63.  License policy:
  64.    You are free to use this code for any purpose as long as you make
  65.    mention of its original author.
  66. ******************************************************************/
  67.  
  68. Consider Robert mentioned, and his AV code has been used to make
  69. a slightly shorter version of AV.EXE for use with WC30VIEW.
  70.  
  71. Vern Buerg is the author of many excellent programs, and I urge those
  72. who use software written by him and Robert to support them as well
  73. as other authors of shareware!
  74. ---------------------------------------------------------------------
  75.  
  76. IMPORTANT NOTES:
  77.  
  78. 1. This program is for WILDCAT 3.0x and later.
  79.    It will NOT work with 2.xx or any earlier versions!  Runs
  80.    on either single-line systems and any/all nodes of a multi-
  81.    line board.  File sharing is supported.
  82.  
  83. 2. You MUST have, somewhere in your PATH, the following:
  84.  
  85.               FV.COM or FV.EXE (c) Vernon Buerg.
  86.               PKUNZIP.EXE (c) Phil Katz
  87.               LHARC.EXE (c) Yoshi
  88.               ARJ.EXE (c) Robert K. Jung
  89.               AV.EXE (c) Robert K. Jung (needed for ARJ files)
  90.               PKXARC.EXE or PKUNPAK.EXE (c) Phil Katz
  91.                (if you want to use PKUNPAK, you must re-name
  92.                 it to PKXARC.EXE; only these exact filenames
  93.                 are valid!)
  94.  
  95. If you absolutely have NO .ARC, .ARJ, or .LZH files in your system,
  96. you don't have to have the corresponding programs....however, keep
  97. in mind that if, for example, you DO have an .ARJ file catalogued
  98. and do NOT have ARJ.EXE and AV.EXE in your PATH (or the current
  99. working directory when this program is run), it will lock up your
  100. system.  I didn't include code to FORCE these programs to be in-
  101. stalled in your system for those sysops who absolutely know for
  102. sure they will not have one or more of these archive types.
  103.  
  104. >  All the above are required for 2 reasons: fairly regular changes in
  105. >  these archiving utilities occur, making an 'all-in-one' de-arcing
  106. >  program difficult to maintain, and we believe that the authors
  107. >  of those programs would prefer to have THEM used to
  108. >  extract files created BY them, respectively.
  109.  
  110. 3. If you have any problems running WC30VIEW it is probably due
  111.    to either (a) failing to have the programs above in your PATH,
  112.    or (b) running out of memory.  WILDCAT does a shell to DOS for the
  113.    View Arc function, and furthermore, WC30VIEW invokes another
  114.    copy of COMMAND.COM which loads the un-archiving programs
  115.    (PKUNZIP, etc.).  You will need about 150K free memory after
  116.    WILDCAT shells to [V]iew arc, so you MAY have to change your
  117.    MAKEWILD settings so that WILDCAT is swapped out of memory
  118.    for this (and external protocol) functions.  Unless you have
  119.    an awful lot of memory-resident stuff, it shouldn't be a
  120.    problem.
  121.  
  122. 4. There is no 'LOCAL' option on this program.  It ONLY talks to
  123.    the COM port that Wildcat uses.  You can always drop to DOS
  124.    and use any of the programs described above.  If you log on
  125.    locally and attempt to [V]iew an archive, the program will
  126.    abort and return you to WILDCAT.
  127.  
  128. 5. I have not included the ability to Download individual parts of
  129.    an archive.  That's my personal preference; I don't like just
  130.    'pieces' of an archive to get distributed around....but if there
  131.    is sufficient demand for this feature (?), I will consider adding
  132.    it.
  133.  
  134. WC30VIEW will be invoked in your \wc\wcwork\nodex directory, where
  135. VIEWCOMP.BAT gets copied to.  Edit it in your Wildcat home node dir-
  136. ectory for the node in question, just as you normally would.
  137.  
  138. Carrier detect is monitored and returns to the board if a caller
  139. drops carrier.  WILDCAT then takes over and recycles in the normal way.
  140.  
  141. Callers using ANSI  will see different portions of their selections
  142. in colors.....prompts green, archive contents list yellow, warnings
  143. in red or flashing red, and ASCII files in bright cyan.
  144.  
  145. The 'chat' function is included in case you need to yell at
  146. the user real quick for some reason.  The user can NOT page you
  147. or INITIATE the 'chat' which is a very rudimentary kind;
  148. it does not include line-wrap or other fancy stuff.
  149.  
  150. You can dump a user immediately back to the board by pressing ESC.
  151.  
  152. To install WC30VIEW:
  153.  
  154. Create or edit VIEWCOMP.BAT in your Wildcat HOME NODE DIRECTORY,
  155.     It should contain ONLY this ONE line: (other than REMs you may
  156.     want for reference)
  157.  
  158.        wc30view %1 n
  159.  
  160.        In place of the 'n', put a number.  This is the number of
  161.        MINUTES  the caller will be allowed in this program,
  162.        REGARDLESS of his activity and will send him back to
  163.        your board after that time.  5 or 6 minutes should be
  164.        plenty for most applications. The timer stops during
  165.        a 'chat' with the user.  In any case, the user's keyboard
  166.        is checked and WC30VIEW will dump him back to WILDCAT
  167.        after 5 minutes of inactivity.
  168.  
  169. ***** DO NOT use the '>' redirection to a file such as has been
  170.       used with PKUNZIP, etc....like: pkunzip %1 > viewcomp.dat,
  171.       and do NOT try to return to WILDCAT with a CAT.BAT command!
  172.  
  173. That's all there is to it; the program gets everything it
  174. needs from the various WILDCAT system files.
  175.  
  176. If you find this program useful, a registration of $10 or thereabouts
  177. is in order.  Doing so will get you support for the program and
  178. modifications you may want, within reason.  Thanks!
  179.  
  180. -end of file-
  181. ---------------------------------------------------------------
  182.